home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / program / rukc121s.zip / !readme < prev    next >
Text File  |  1996-07-30  |  4KB  |  100 lines
  1. 30-July-1996
  2.  
  3. NEW E-MAIL INFO
  4. ---------------
  5.  .                                             .
  6.  :    Quality Toolkits and Applications for    : info@40th.com
  7.  :          DOS - Win16 - Win32 - OS/2         : http://www.40th.com/
  8.  :                                             : BBS:1-210-684-8065
  9.  
  10.  
  11. SIMPLE INSTALLATION and USE
  12. ---------------------------
  13. The RUCKDAC.LIB file reference should be changed to refer to RUCKDAC.OBJ.
  14. If a LIB file is needed (no real reason it should be), you can easily
  15. create a LIB file by doing this:
  16.  
  17.         C>lib ruckdac.lib ruckdac.obj;
  18.  
  19.  
  20. More information on the major changes in this shareware distribution
  21. are detailed in the !history file.  There is no install program.
  22.  
  23.  
  24. NATIVE SB16 PLAYBACK SUPPORT
  25. ----------------------------
  26. The examples in xmplesrc.zip do not include the new SB16 device,
  27. which is physical device number 6.  See "OTHER STUFF", below, for
  28. more info.  For BASIC, the separate include files for QB45 and BASIC7
  29. were combined into just one; update the BASIC7-specific source examples
  30. to include RUCKDAC.BI.
  31.  
  32.  
  33. USING XMS MEMORY for VOC/WAV STORAGE
  34. ------------------------------------
  35. If your XMS manager is V2.xx you need to set IP.Flags bit5 to 1 if
  36. you want to load VOC or WAV files into XMS memory.  This is needed
  37. in versions of OS/2 up to and included Warp 3.  If you have an
  38. XMS 3+ manager (QEMM, 386MAX, etc.), this is not needed.  For max
  39. compatibility, offer an option to use XMS 2.x.  All versions of
  40. XMS 2.x managers I've tried have worked okay doing DMA into and
  41. out of high memory (memory above 1MB).
  42.  
  43. For BASIC, use IP.Flags = &H20.  For C, use IP.Flags = 0x20.  For example,
  44. in the BASIC source X01*.BAS, near line 247, add the IP.Flags line:
  45.  
  46. ...
  47. IP.Func = InitDac
  48. IP.DeviceID = device
  49. IP.Flags = &H20
  50. SELECT CASE device
  51. ...
  52.  
  53. See the !HISTORY file for more tips and tricks.  The RUCKDAC.DOC file
  54. is the Ruckus-DAC programmer's reference manual.
  55.  
  56.  
  57. OTHER STUFF
  58. -----------
  59. 1. SB16 8-bit playback for VOC/WAV and Mod file playback, in stereo.
  60.  
  61. 2. New VOC format handled.
  62.    Uses block type 9, known as version 1.20.  Old version still supported,
  63.    and is (still) what is used by StoreDac.
  64.  
  65. 3. A new error code, ERR_NOTAVAIL=222.
  66.    This is what you get back if you try to record using the SB16 device.
  67.    Use the SBpro or SB, if possible (both those will be mono, though).
  68.  
  69. 4. The temporary XMS load/store buffer is now 8K, down from previous 16K.
  70.    Means you don't have to give up as much memory (if you use XMS, that is).
  71.  
  72. 5. Did away with the separate Borland version.
  73.    The new memory management scheme should let everyone get along.
  74.  
  75. 6. New header files to reflect the added device.
  76.    Only real difference is SysInfoPack, though other minor changes, too.
  77.  
  78. 7. NOATEXIT.OBJ is updated.  The last version did not assemble correctly,
  79.    though earlier ones should be okay (you'd know already if not).  The
  80.    WCATEXIT.OBJ acts as a _atexit()-redirect (it calls atexit_()).
  81.    Recommended if you use the Watcom compiler when using the in-registers
  82.    calling convention.
  83.  
  84.  
  85. The noise at device init is unavoidable.  Using pre-programmed parameters
  86. should help (rather than auto-detect), and if pre-programmed, you may want
  87. to figure out how to hit the mixer to reduce the VOC volume before init'ing
  88. or shutting down -- the SBs don't always make a noise, but often do during
  89. init and especially if an auto-detect was used (SysInfoDac).
  90.  
  91. There is a flag in IP.Flags that locks the SB "speaker" (output channel)
  92. in an on state.  Doing this means is a lot faster, and much quieter, than
  93. on/off'ing the "speaker" before/after each play.  See the RUCKDAC.DOC file,
  94. Appendix C (or so).
  95.  
  96. You may want to check out the current Modac (1.20).  It was made using this
  97. very same LIB (now simply a .obj file).  It's in the Main Board, SoundTools area,
  98. and at the web site.
  99.  
  100.